home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 4 / Precision Software Applications Silver Collection Volume 4 (1993).iso / database / lst113.exe / LSTDOC2.TXT < prev    next >
Text File  |  1992-01-27  |  54KB  |  1,239 lines

  1.                                    BACKUP MODULE
  2.  
  3.  
  4.                When you select this menu option, a copy of the currently 
  5.           loaded PDF file is saved to the current directory, with the 
  6.           extension BAK appended to the filename. 
  7.  
  8.                For example, let's say that you are working with a file named
  9.           business.pdf. You have had this file for some time and so it 
  10.           contains many addresses that would be too difficult or troublesome 
  11.           to replace. This is when you should select Backup.
  12.  
  13.                After you select Backup, the following message will be
  14.           displayed;
  15.  
  16.           " A copy of _______  will be made and named _________.BAK." 
  17.  
  18.                The first group of dashes will be replaced with the name of
  19.           the currently loaded PDF file, which in this case is business.pdf.
  20.           The second group of dashes will read business.bak. An additional
  21.           prompt would then read;
  22.          
  23.                         "Do you wish to continue? y/n." 
  24.  
  25.                If you press the <Esc>, or the <n> keys, the operation is
  26.           halted and you will be returned to the main menu. Any other key
  27.           will let the operation continue. 
  28.  
  29.                The current directory of the current drive will then be
  30.           searched to see if the name business.bak is already in use. If a
  31.           file is located with that name, then you will be shown a menu that
  32.           reads;
  33.  
  34.           The file BUSINESS.BAK already exists.
  35.           Do you wish to 
  36.           (1) Replace BUSINESS.BAK with the current contents of BUSINESS.PDF
  37.           (2) Make new backup copy of BUSINESS.PDF and rename this backup?
  38.  
  39.           Press the number of your choice or <ESC> to quit.
  40.  
  41.                Pressing the number 1 will overwrite the previous contents of 
  42.           the file BUSINESS.BAK with the current contents of BUSINESS.PDF. 
  43.           This option will be the one that you choose most often. In fact, 
  44.           if you make frequent backups this is the only option you would 
  45.           choose, unless you wish to keep dated backups, such as, BUS791 -
  46.           July 1991, or BUS1091 - October 1991. If this is the case select
  47.           (2) to get the second menu option.
  48.  
  49.                Pressing the number 2 will display the prompt;
  50.  
  51.                  " Enter new filename, (8 letters or less) >".
  52.  
  53.                The name you input will then be scanned for on the current 
  54.           directory. If it is found you will be prompted again for another 
  55.           name. This process continues until a unique filename is found. 
  56.           Then the program makes a copy of the file business.pdf, naming 
  57.           the copy with the unique filename you supplied and adding the 
  58.           BAK extension.  
  59.  
  60.           List-It!                     -19-
  61.  
  62.  
  63.                When the operation is complete, the screen will be cleared and
  64.           a final prompt will read;
  65.  
  66.                   " The file ________.PDF has been successfully 
  67.                     backed up to ________.BAK. "  
  68.  
  69.                The underline marks will be filled with the appropriate
  70.           filenames.
  71.  
  72.  
  73.                If one of your main PDF files becomes corrupted, or if you
  74.           inadvertently delete it, and are unable to retrieve the file, then
  75.           you need to use the backup copy you made. (You did remember to 
  76.           back up your data files right?) However, before you attempt to use
  77.           your back up copies, you must rename the file and give it a PDF
  78.           extension. 
  79.  
  80.                To rename your back up copy issue the following command at 
  81.           the DOS prompt:
  82.            
  83.                   C:\ren c:\phone\business.bak business.pdf
  84.  
  85.                Or, alternatively, you can use whatever file management 
  86.           software you are familiar with to rename the file with the PDF 
  87.           extension.
  88.  
  89.                Whichever method you use, you will then be able to start the
  90.           program and use the file as you did the original. Just remember to
  91.           back up the file before you quit the program. 
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.           List-It!                     -20-                                    EXPORT/IMPORT 
  120.  
  121.  
  122.                Choosing this option from the Utility sub-menu displays       
  123.           another short menu. This is where you choose the operation you     
  124.           wish; either importing a file or exporting the currently loaded    
  125.           file.
  126.  
  127.                                       EXPORT
  128.  
  129.  
  130.                The export operation allows you to make an ASCII copy of the
  131.           currently loaded PDF file. One that can be read from the DOS
  132.           command line by entering the command, "type file.pdf", (where you
  133.           substitute the name of the file in place of FILE).  
  134.           
  135.                Choosing this option creates the file: FILE.TXT. The name of 
  136.           the file that is currently being used is stripped of the PDF 
  137.           filename extension and has the extension TXT put in its place. The 
  138.           current directory is then scanned to see if that filename already 
  139.           exists.  
  140.  
  141.                If the filename is unique, then the contents of the 
  142.           database are exported to the newly created file, one line at a
  143.           time, and are written in ASCII format. When the end of a record is 
  144.           reached, the tilde (~) character is then written to the file 
  145.           followed by a carriage return. This marks the end of the record.
  146.  
  147.                The contents are exported in the same order that the print
  148.           module uses when printing out the entire contents of the database.
  149.      
  150.                Last Name First Name
  151.                Address
  152.                City, State Zip code
  153.                Area code Phone
  154.                Contact
  155.                Company
  156.                Business Area code Business phone and extension
  157.                Fax Area code phone
  158.                Notes
  159.                ~
  160.  
  161.                However, if the file name does already exist, you are then
  162.           allowed to do one of 3 things.
  163.                
  164.                1. Allow the program to continue, which will cause the 
  165.                   previous contents of FILE.TXT to be overwritten.
  166.                2. Give the program a new name under which to export the file.
  167.                3. Escape the operation.
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.           List-It!                     -21-                                       IMPORT
  179.  
  180.  
  181.                Import allows you to use an existing database, one created by
  182.           another program, so you will not have to re-enter your records
  183.           to use List-It!. 
  184.               
  185.                However, certain caveats exist. First, your existing program
  186.           must be able to create an ASCII version of its database, with a
  187.           special character separating the records. Most programs out today
  188.           have this ability so there should be no problem in meeting this
  189.           requirement. You must convert your database to ASCII because
  190.           List-It!, as currently written, does not read databases in their
  191.           native format. 
  192.  
  193.                It would also be preferable, if you could have your program
  194.           export records in a way that matches the format shown on the
  195.           previous page. That is, by having name and address information in 
  196.           a mailing list format, and by having area codes and phone numbers
  197.           on the same line. This is how List-It! exports records. If this is
  198.           not possible, then you must make sure that only one field gets
  199.           exported per line. 
  200.      
  201.                An example of one field per line in your exported file:
  202.  
  203.                           Last Name
  204.                           First Name
  205.                           City
  206.                           State
  207.                           Zip code      and so on.
  208.  
  209.                The second more immediate concern is that when importing 
  210.           records that are not completely filled, the imported information 
  211.           will not be placed into its proper field. 
  212.  
  213.                For instance, let's say that your records contain the 
  214.           following fields; Company name, business area code, business phone 
  215.           number and notes. Now suppose the area code field is empty, so of
  216.           course, nothing would be exported for this field. When List-It!
  217.           tries to import the information in this record, it will correctly
  218.           recognize the Company's name, but it will import the next line it
  219.           sees - the phone number - as the area code since that is the next
  220.           field it expects. Then from that point in the record, every field
  221.           will be treated incorrectly. 
  222.  
  223.                You can however, restrict misreading records to only those
  224.           records with missing fields, by insuring that there is a character
  225.           separating the records in your exported file. Again, most of 
  226.           today's programs do this, so there should be no problem. Then when
  227.           you have finished importing you can go into the file, and edit
  228.           those records with the missing fields. 
  229.  
  230.                When you first select Import you will see a message warning
  231.           you that only ASCII text files can be properly imported. If you 
  232.           try to import anything else, you will end up with garbage. It also
  233.           advises you of the problem created by records containing missing
  234.           fields. Just press a key to continue. You are then allowed to exit
  235.           the module, by pressing the <Esc> key.
  236.         
  237.           List-It!                     -22-
  238.    
  239.  
  240.                You will next be prompted for the file name to import. You
  241.           must give the full path here, including the extension. 
  242.           
  243.                For example: c:\arc\data.txt
  244.      
  245.                The program then checks to see that the filename given 
  246.           represents an actual file. If it cannot find the file, you are 
  247.           notified of that fact and allowed to enter a new filename. Don't
  248.           forget to use the full path!
  249.  
  250.                 Once the program has verified the existence of the file, it 
  251.           takes the filename from the path, strips the extension txt and 
  252.           appends PDF to it. It then checks the current working directory for
  253.           the existence of this newly created name, allowing you to give it a
  254.           new name, if the one you provided is already in use. 
  255.  
  256.                You will then see these filenames near the top of the screen;
  257.  
  258.           File to import: c:\arc\data.txt
  259.           Save as: e:\listit\data.pdf (SEE NOTE)
  260.  
  261.                Next you will be prompted with the message;
  262.  
  263.           "Is there one field per line in the file to be imported? y/n"
  264.  
  265.                Press the <y> key only if the answer is yes. Press another 
  266.           key to continue. 
  267.  
  268.                 You are next prompted for the character used as a record 
  269.           separator, and for the total number of fields in a record from the
  270.           file that you are importing. This number should include every
  271.           field in the record, not just the ones that got exported. You can
  272.           get this number from the manual detailing the operation of the
  273.           other program or from the entry screen of the program, by just
  274.           counting the fields that appear on your monitor. 
  275.        
  276.                Next you will see all the fields in a List-It! record, with 
  277.           an entry field beside each one. This is where you tell the program
  278.           the order the fields take in the database you are importing from.
  279.           The numbers you enter here are very important, so to be sure, 
  280.           check the manual of the other database for the necessary order.
  281.  
  282.                Pressing F1 activates a series of help screens, in case you
  283.           are stuck and don't know how to proceed. If you press the <Esc> 
  284.           key at any field position, you will quit the Import module and
  285.           return to the main menu.
  286.  
  287.                You MUST press the return key after entering each field's 
  288.           number order. 
  289.  
  290.           NOTE: The program places the file data.pdf in the current working
  291.           directory. In this case the current working directory is the 
  292.           listit directory of the E drive. Even if you had typed d:\data,
  293.           it would still build e:\listit\data.pdf. 
  294.  
  295.  
  296.           List-It!                     -23-          
  297.  
  298.  
  299.                If you have entered the same number twice, the program will 
  300.           display those numbers in a different color to make the error more
  301.           visible. You must then move to the incorrect entry, with the up 
  302.           or down cursor keys, and enter the proper order number.
  303.  
  304.                When you are done ordering the fields press the <F9> key. 
  305.  
  306.                The program then counts the fields you have tagged, displays
  307.           the count and asks, "OK to proceed? y/n". The Import routine will
  308.           only continue if you press the <y> key, at which time it will 
  309.           display the fields in sorted order and begin the import operation.
  310.           Press another key besides the <y> key, and you will be allowed to
  311.           re-enter any information you might have forgotten. 
  312.  
  313.                Once import begins, memory is set aside in RAM for each 
  314.           record as it is read from the imported file. When the last record
  315.           is read, the program then writes the information to disk, saving 
  316.           it under the name data.pdf. This file is then read back into 
  317.           memory so that you can use it immediately. 
  318.          
  319.                The Import operation was timed with a text file containing 280
  320.           records of six fields each. The entire operation took about 70
  321.           seconds on an XT Turbo. 
  322.  
  323.                If all this seems a bit complicated, perhaps its time for a
  324.           walk through the Import process.
  325.  
  326.                After you have selected Import/Export from the utility
  327.           sub-menu, you will see the following; 
  328.  
  329.  
  330.                                (1) Import file.                              
  331.                                (2) Export file.                              
  332.  
  333.                                                                        
  334.                        Press number of your choice or <ESC> to quit. 
  335.  
  336.                Press 1 to enter the Import Module. A window will pop up
  337.           displaying the warning about only importing ASCII files. Press any
  338.           key to erase the window, and continue with the Import process. 
  339.           You will next be prompted for the imported file's name.
  340.  
  341.           Import:                                                            
  342.           Save as:                                                           
  343.  
  344.           Enter file name to import. Include extension and path.
  345.           ___________________________________________________________
  346.                                                                
  347.  
  348.                Here you would enter c:\arc\data.txt. (That is, providing the
  349.           file you want to import is named data.txt and that it resides in
  350.           the directory arc of the C drive).
  351.               
  352.                You must now answer the question relating to the ordering 
  353.  
  354.  
  355.           List-It!                     -24-
  356.  
  357.             
  358.                of fields in the file you are importing from. Is there one
  359.           field per line? Answer yes by pressing the <y> key if that was how
  360.           you had the file created. Press another key if there is more than
  361.           one field per line. 
  362.                
  363.                You are now asked if there is a character used to separate
  364.           records.
  365.     
  366.                It is VERY important that you enter the character your program
  367.           used as a record separator in creating the ASCII file. This is to 
  368.           ensure that when records are not completely filled, incorrect
  369.           importing is limited to that one record, that is, the incomplete
  370.           record.
  371.  
  372.                If there is no record separator press the <Enter> key. Then 
  373.           enter the number of fields in your database. Enter 9 if you have 9 
  374.           fields in the record. Here is the screen at this point:
  375.  
  376.           Please enter character used as a record separator.  
  377.           If there is no record separator press ENTER. ~_      
  378.           Please enter total number of fields in file being imported. 9__ 
  379.  
  380.           The following screen will then appear:
  381.  
  382.          ┌─────────────────────────────────────────────────────────────────┐
  383.          │ Import module              Press <F9> when you are finished.    │ 
  384.          ╞═════════════════════════════════════════════════════════════════╡ 
  385.          │                       Importing file                            │ 
  386.          │                                                                 │
  387.          │ Import: c:\arc\data.TXT                                         │ 
  388.          │ Save as: data.PDF                                               │ 
  389.          │ Record Delimiter: ~                                             │
  390.          │ Total Records: 9     Last Name      ___                         │ 
  391.          │                      First Name     ___                         │ 
  392.          │                      Address        ___                         │ 
  393.          │                      City           ___                         │ 
  394.          │                      State          ___                         │ 
  395.          │                      Zip            ___                         │ 
  396.          │                      Area code      ___                         │ 
  397.          │                      Phone          ___                         │ 
  398.          │                      Company Name   ___                         │ 
  399.          │                      Contact        ___                         │ 
  400.          │                      Bus area code  ___                         │ 
  401.          │                      Bus phone      ___                         │ 
  402.          │                      Ext            ___                         │ 
  403.          │                      Fax area code  ___                         │ 
  404.          │                      Fax            ___                         │ 
  405.          │                      Notes          ___                         │ 
  406.          │                                                                 │ 
  407.          └─────────────────────────────────────────────────────────────────┘
  408.                                       Figure 9
  409.  
  410.                This is where you must check the order of fields in your other
  411.           database. Suppose that you have all the above fields, except for 
  412.           the fields relating to business, contacts and fax, a total of nine 
  413.  
  414.           List-It!                     -25-
  415.  
  416.  
  417.           in all. And that they take the following order in your database; 
  418.           First name, last name, address, state, city, zip code, area code, 
  419.           phone number and notes. The screen will then look like this after 
  420.           you have finished numbering the fields.
  421.   
  422.                               Last Name      2__                             
  423.                               First Name     1__                             
  424.                               Address        3__                             
  425.                               City           5__                             
  426.                               State          4__                             
  427.                               Zip            6__                             
  428.                               Area code      7__                             
  429.                               Phone          8__                             
  430.                               Company Name   ___                             
  431.                               Contact        ___                             
  432.                               Bus area code  ___                             
  433.                               Bus phone      ___                             
  434.                               Ext            ___                             
  435.                               Fax area code  ___                             
  436.                               Fax            ___                             
  437.                               Notes          9__                             
  438.  
  439.  
  440.                Then press the <F9> key. The program then totals the fields,
  441.           letting you know you there were 9 entries. It next asks if you wish
  442.           to proceed, giving you the option to go back and correct any
  443.           entries you have made. 
  444.  
  445.                If you do notice an incorrect entry was made and wish to
  446.           delete it, you must move the cursor to the field entry in question
  447.           and press the zero key. The incorrect entry will be replaced by
  448.           zero and then exchanged with an underline character when you hit
  449.           <Enter>. 
  450.  
  451.                After you have examined the screen and are satisfied with
  452.           the entries, press the <F9> key again and then the <y> key to
  453.           continue. The fields will be re-displayed in the order that they
  454.           will be imported and the import process will start. 
  455.  
  456.                The file C:\ARC\DATA.TXT is then read into memory one record
  457.           at a time. When the end of the file is reached, the file DATA.PDF
  458.           is created and the contents of the file just read are written to
  459.           disk. After DATA.PDF has been successfully saved, it is then loaded
  460.           back into memory, all pointers are adjusted, and you can use the
  461.           file as you would any other PDF file. 
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.           List-It!                     -26-                                      LOAD FILE
  474.  
  475.  
  476.                The Load File option allows you to choose the PDF file you
  477.           wish to work with. When this option is selected, (from the Utility
  478.           sub-menu), a window will appear containing the names of any PDF
  479.           file the program  finds in the current directory. (SEE NOTE)
  480.                
  481.                You will also see within the window a highlight bar which 
  482.           can be moved with any cursor key. To load in a new file, just 
  483.           move the highlight bar to the desired file, hit <Enter> and the 
  484.           file will be loaded.
  485.  
  486.                The ability to keep your mailing lists and/or telephone
  487.           numbers in different files, gives you great freedom in structuring
  488.           those lists, especially as they grow in size. Business contacts 
  489.           can be kept in one file, suppliers in another, and your
  490.           acquaintances in yet another file. 
  491.  
  492.                As an example, we'll produce a PDF file for a very specific
  493.           purpose. Let's say you need to maintain the addresses of your
  494.           bowling club members, so that you can mail them notices of
  495.           upcoming events or notify them when league fees are due. This
  496.           would be easier if you had a separate file with only the members
  497.           of the bowling league included. To build such a file, take the
  498.           following steps. (These steps assume these addresses already exist
  499.           within another PDF file).
  500.  
  501.                First select copy from the Utility sub-menu. Then type in 
  502.           bowling when asked for the name to save the copied file to. 
  503.  
  504.                The original PDF file will then be copied and the copy will 
  505.           be named bowling. Then you go to Load File from the utility 
  506.           sub-menu and load in the file bowling. Choose the Look module to
  507.           scan the records and delete each one that doesn't need to be
  508.           included. (All those that aren't members of your bowling league.)
  509.           When you have reached the last record, return to the main menu and
  510.           select Zap. This will permanently remove the records you deleted.
  511.           You will now have a file named bowling that only contains members
  512.           of your bowling league.
  513.  
  514.           NOTE: This is normally the directory that you launched List-It!
  515.           from. For instance, if you were in the root directory of the C
  516.           drive, had a sub-directory named mail which contained the program
  517.           List-It!, and then typed:
  518.  
  519.           c:\mail\lst.exe 
  520.  
  521.                Then the root directory will be your current directory, and
  522.           the program will search the root for PDF files. If however, you
  523.           also want to keep your data files in the directory mail, then
  524.           before you run List-It! you must change the current directory to
  525.           mail. To accomplish this type the following, (or put it in a batch
  526.           file, to save yourself the typing.)
  527.  
  528.           c:
  529.           cd /mail
  530.           lst
  531.  
  532.           List-It!                     -27-                                     COPY MODULE
  533.  
  534.  
  535.                This menu option makes a copy of the currently loaded PDF
  536.           file, and then renames it with a name of your choice.
  537.  
  538.           When you select this option you are prompted with the question:
  539.  
  540.           " Enter new file name - (8 letters or less) > ".
  541.  
  542.                You then enter whatever name you wish. The program scans 
  543.           the current directory to see that this name does not duplicate the
  544.           name of an already existing file. If the program finds another
  545.           file with the same name, you are prompted with the message;
  546.  
  547.           "File already exists. 
  548.            Press <Esc> to quit or any other key to try again."
  549.  
  550.                You can then either return to the main menu by pressing the 
  551.           <Esc> key, or press another key to enter a different filename. 
  552.           This process is continued until a unique filename is found.
  553.  
  554.                Once you have unique file name, it will be used to name the
  555.           copy of the currently loaded PDF file. The extension PDF will then
  556.           be appended. You will now be able to load this copy and use it as
  557.           you would any other PDF file. (To load the file you must select 
  558.           the menu option Load File on the Utility sub-menu.) 
  559.  
  560.                One possible use of this option would be when you want to
  561.           split the original data file, (LISTIT.PDF), into 2 files because
  562.           it is now too large and too slow to use efficiently. There are 
  563.           many business contacts, as well as personal contacts, and you feel
  564.           that you want to have them in separate PDF files. To split the 
  565.           file take the following steps: 
  566.  
  567.                From the main menu press <u>, then <c>. Type in the word 
  568.           business at the prompt. A copy of LISTIT.PDF will be made and named
  569.           BUSINESS.PDF. Then press <Esc> to return to the main menu. Now you 
  570.           have to load in the newly created file. Press <u> then <l>, and
  571.           move the highlight bar to BUSINESS.PDF and hit <Enter>. The file 
  572.           BUSINESS.PDF will be loaded. 
  573.  
  574.                Now all you have to do is delete all the personal contacts
  575.           from the file. Then, if you want to make these changes
  576.           permanent, select Zap from the main menu. All personal contacts
  577.           will now be permanently removed from the database BUSINESS.PDF. 
  578.  
  579.                You can of course, duplicate this process to create a file
  580.           with nothing but personal contacts. Repeat the above steps but 
  581.           name the copy PERSONAL and delete the business contacts.
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.           List-It!                     -28-                                 COLOR CHANGE MODULE
  592.  
  593.  
  594.                When the program first loads, it checks your equipment 
  595.           to see what color mode your system is running in. If it 
  596.           finds that your system is running a monochrome monitor, then you 
  597.           will not be able to access this option. If you did, then a
  598.           window would pop up telling you that a color monitor is necessary
  599.           to access this menu selection.
  600.  
  601.                If you do have a color monitor, or even better, an EGA/VGA
  602.           monitor, then you can customize the colors the program uses to your
  603.           liking. 
  604.  
  605.                What follows is displayed when you first choose this option.
  606.                       
  607.           ┌────────────────────────────────────────────────────────────────┐
  608.           │                                                                │
  609.           │                     Color change menu                          │
  610.           │                                                                │
  611.           │                                                                │
  612.           │                F2: To change background color                  │
  613.           │                F3: To change foreground color                  │
  614.           │                F4: To change menu bar color                    │
  615.           │                F5: To change the first letter color            │
  616.           │                F6: Restore original color settings             │
  617.           │                F7: To save current colors to disk              │
  618.           │                F9: Quit                                        │
  619.           │                                                                │
  620.           │                Press number of desired choice                  │ 
  621.           │                                                                │ 
  622.           │                                                                │
  623.           │                Color >>                                        │
  624.           │                                                                │ 
  625.           └────────────────────────────────────────────────────────────────┘
  626.                                       Figure 10
  627.  
  628.                Each of the function keys, (F2 thru F5), allow you to change
  629.           the color of some part of the screen. You can change the background
  630.           of the monitor. You can change the color of any characters written
  631.           to the screen. You can also change the color of the line drawn
  632.           underneath the main menu, or the color of the first letter of each
  633.           menu option. Once the screen colors are to your liking you can
  634.           press the <F7> key and save the color selections to disk. 
  635.  
  636.                Don't worry, if you do not explicitly save your color
  637.           selections to disk. When you select Quit from the main menu, the
  638.           program checks to see if the color attributes have been changed. 
  639.           If they are different from the original colors then they are
  640.           automatically saved. Then when the program is run again, these
  641.           saved colors are brought back and used. So you only have to select
  642.           colors once, and the program will always use your selected colors
  643.           in the future. 
  644.  
  645.          
  646.  
  647.  
  648.          
  649.  
  650.           List-It!                     -29-
  651.  
  652.  
  653.                Any color changes you make to the background or foreground,
  654.           are used as soon as you exit one of the color sub-menus. However,
  655.           the other selections concern the main screen display area, so you
  656.           can not see these changes until you exit the color change module.
  657.           If the colors are not to your liking, then re-enter the color
  658.           change option and choose again. 
  659.  
  660.                To select a color while in any color change sub-menu, just
  661.           press the number alongside the desired color. The selected color
  662.           will then appear in a small box next to the words, "Color >>". 
  663.           This gives you the chance to see how the color displays on your
  664.           monitor. The colors can also be selected by pressing the up or 
  665.           down cursor keys. They will respectively advance or reduce the
  666.           color attribute. Each press of these keys displays a different
  667.           color. 
  668.  
  669.                Pressing <F2> allows you to change the background colors.
  670.           You can select from the following eight colors:
  671.  
  672.           Black, Blue, Green, Cyan, Red, Magenta, Brown, and Light Grey.
  673.  
  674.                When you press the <F3>, <F4>, or <F5> keys, you are shown 16 
  675.           colors from which you can select a new color. They are:
  676.  
  677.           Black, Blue, Green, Cyan, Red, Magenta, Brown, Light Grey,
  678.           Dark Grey, Light Blue, Light Green, Light Cyan, Light Red,
  679.           Light Magenta, Yellow, and White.
  680.  
  681.                Selecting the <F6> key restores the colors that originally 
  682.           came with the program, the colors that I feel are the most 
  683.           attractive and pleasing to the eye, on a VGA monitor. They are
  684.           listed here:
  685.  
  686.                The line under the menu bar is colored Cyan.
  687.                The background is Blue.
  688.                The foreground is Yellow.
  689.                The first letter of menu choices is colored Light Red.
  690.  
  691.                Selecting the <F7> key gives an explicit command to save the
  692.           current colors to disk. 
  693.  
  694.                To quit the color change menu and return to the main menu,
  695.           press either the <F9> or the <Esc> keys. 
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.           List-It!                     -30-                                     RENAME FILE
  710.  
  711.  
  712.                The Rename file option, reached from the Utility sub-menu, 
  713.           allows you to change the name of the database that you are
  714.           currently using. 
  715.  
  716.                You will be prompted for the name you wish the file to have.
  717.           Use any name you wish as long as it is no more than 8 letters 
  718.           long. Type in the name and press the <Enter> key. The program will
  719.           make sure that the name you give it is unique, that is, that it is
  720.           not already in use. 
  721.  
  722.                If the filename is found to be unique, then the database is
  723.           renamed, and the following message is displayed;
  724.  
  725.                 "FILE.PDF was successfully renamed to FILENEW.PDF.
  726.  
  727.                Where FILE.PDF was the original name and FILENEW.PDF is the
  728.           new name.
  729.  
  730.                However, if the program finds that the new filename is already
  731.           in use, then you will be prompted with the message;
  732.  
  733.           "The file FILENEW.PDF already exists."
  734.  
  735.                You are then allowed to re-enter a new filename or you can
  736.           press the <Esc> key to exit the module.
  737.  
  738.                If the program was not able to rename the database file then
  739.           the message;
  740.  
  741.          "Unable to rename file ______ to ________.",
  742.  
  743.           will appear on your screen. 
  744.  
  745.  
  746.  
  747.                              
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.           List-It!                     -31-                                      GET INFO
  769.  
  770.  
  771.  
  772.                This menu option will show you several figures, telling you
  773.           about the status of the PDF file you currently have loaded. One
  774.           figure (Records), shows you the amount of records the database can
  775.           hold. It arrives at this figure by taking a look at the total RAM,
  776.           (not including extended or expanded memory), you have available in
  777.           your machine after the program is loaded. It then divides that
  778.           amount by the record size.
  779.  
  780.                There is currently a fixed limit to the number of records 
  781.           you can enter because the program loads the entire database into 
  782.           memory. This limit is reduced even further if the program is 
  783.           operated from a floppy disk, since the database is placed into the 
  784.           same drive that the program is operated from. So please realize
  785.           that in order to use the larger record capacity of the program you
  786.           must operate it from the hard drive. 
  787.  
  788.                Also remember that the program gives you the option to choose 
  789.           the PDF file, (database), you wish to use so that, in effect, there
  790.           is no limit to the number of records you can work with, as long as 
  791.           you split them up into separate files. 
  792.  
  793.                The next figure is Records Used. It will show you the number
  794.           of records that exist within the currently loaded PDF file. 
  795.  
  796.                The last figure, Records Left shows the number of records you
  797.           can enter into the database. This amount is reduced by the number
  798.           of records that have been deleted, since they still physically
  799.           exist and take up space within the file.    
  800.  
  801.                As an example; if you have space for 1200 records, your
  802.           database contains 200 records, and you have deleted 25 records then
  803.           you still have space for 975. (1200 - 200 - 25 = 975). 
  804.  
  805.                The last figure, Records To Zap, shows the number of records
  806.           that have been tagged for deletion. Remember that when you delete a
  807.           record, it is not permanently removed but only tagged. You always
  808.           have the option to bring back or un-delete these records. This
  809.           figure will be zero  after you Zap your file or, if you haven't
  810.           deleted any records.
  811.  
  812.                A help window can be activated while you are viewing the Get 
  813.           Info window. It is the same window you see when you are in the 
  814.           utility sub-menu, and you press <F1> when the Get Info function is 
  815.           highlighted. 
  816.  
  817.           Samples of these two windows are on the following page:
  818.                                                                 
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.           List-It!                     -32-
  828.  
  829.           
  830.           ┌─────────────────────────────────────────────────────────────────┐
  831.           │ Find  Browse  Sort  Zap  Enter  Delete  Print  Utility  Quit    │
  832.           ╞═════════════════════════════════════════════════════════════════╡
  833.           │                                             ┌──────────────┐    │
  834.           │                                             │Directory     │    │
  835.           │                                             │Backup        │    │
  836.           │                                             │Import/Export │    │
  837.           │                                             │Load file     │    │
  838.           │                                             │Copy file     │    │
  839.           │                                             │Change colors │    │
  840.           │                   ╔════════════════════════╗│Rename file   │    │
  841.           │                   ║ Memory Available for:  ║│Get Info      │    │
  842.           │                   ║   1235  Records        ║│Undelete      │    │
  843.           │                   ║   6     Records Used   ║└──────────────┘    │
  844.           │                   ║   1229  Records Left   ║                    │
  845.           │                   ║   0     Records to Zap ║                    │
  846.           │                   ╚════════════════════════╝                    │
  847.           │                                                                 │
  848.           │                                                                 │
  849.           └─────────────────────────────────────────────────────────────────┘
  850.                                       Figure 11
  851.  
  852.                The above screen shows that there is currently room for 1235
  853.           records. There are currently 6 records in the file. 1229 records
  854.           can still be added. And no records have been deleted. If any record
  855.           had been deleted, the Record to Zap figure would equal the number
  856.           of deleted records. 
  857.  
  858.           The second help window follows:
  859.  
  860.  
  861.           ┌─────────────────────────────────────────────────────────────────┐
  862.           │ Find  Browse  Sort  Zap  Enter  Delete  Print  Utility  Quit    │
  863.           ╞═════════════════════════════════════════════════════════════════╡
  864.           │                                             ┌──────────────┐    │
  865.           │                                             │Directory     │    │
  866.           │                                             │Backup        │    │
  867.           │       ╔════════════════════════════════════════════════════╗    │
  868.           │       ║ Total Records - The largest number of records your ║    │
  869.           │       ║   database can hold. Linked to available RAM.      ║    │
  870.           │       ║ Records Used  - Number of records in your database.║    │
  871.           │       ║ Records Left  - Number of records you can add.     ║    │
  872.           │       ║ Records To Zap- Number of records you have deleted ║    │
  873.           │       ║   but have not yet zapped. Zapping your database   ║    │
  874.           │       ║   removes all deleted records. So if you haven't   ║    │
  875.           │       ║   zapped your database in a while, you will be able║    │
  876.           │       ║   to undelete any records that have been marked for║    │
  877.           │       ║   deletion.                                        ║    │
  878.           │       ╚════════════════════════════════════════════════════╝    │
  879.           │                                                                 │
  880.           └─────────────────────────────────────────────────────────────────┘
  881.                                       Figure 12
  882.  
  883.                                                
  884.  
  885.  
  886.           List-It!                     -33-                                      UNDELETE                                
  887.  
  888.  
  889.  
  890.                When you delete a record from the database, the program
  891.           does not physically remove it. As stated earlier in the discussion
  892.           of the Zap module, the record is merely tagged for deletion.
  893.           Nothing else is done. It still remains in the database, but the
  894.           program and you, cannot access the record. 
  895.  
  896.                The program first tests the delete tag of each record before 
  897.           displaying it or, if you are within the Find module, to see if it
  898.           contains the search characters you are looking for. If this tag is
  899.           set, then the program goes to the next record. 
  900.  
  901.                This module allows you to bring back those records that have
  902.           been deleted, as long as the database has not been Zapped yet. 
  903.  
  904.                Choosing this option causes the program to search for all 
  905.           records whose delete tags have been set. If none are found then you
  906.           will be shown a message to that effect.
  907.  
  908.                Records that do have the delete tag set will display on the 
  909.           screen along with the prompt;
  910.  
  911.                            "Undelete this record? y/n"
  912.  
  913.                Pressing the <y> key resets the delete tag in the record to
  914.           zero. If you press any key other than the <y> key then nothing is
  915.           done to the displayed record and the next record with its delete
  916.           tag is then displayed. This process is continued until the last
  917.           record with its delete tag has been displayed. You will then see
  918.           the following message;
  919.  
  920.                    "There are no more records marked for deletion."
  921.  
  922.                This feature was added with the knowledge that you always seem
  923.           to need information from a record that has been deleted. So I 
  924.           designed it as a fail-safe. But please remember that since deleted
  925.           records still exist and take up space within the database, that
  926.           they can, if your database is large enough, cause the program to
  927.           work slowly. If you've been maintaining the same PDF file for a
  928.           while and have never Zapped your file, then it is quite possible
  929.           that you could have as many, if not more deleted records than
  930.           records that display. 
  931.  
  932.                If this is the case, and you notice the program running slower
  933.           than usual, then to improve the program's performance, make a copy
  934.           of the PDF file calling it something like oldset. You can then
  935.           safely zap your database, knowing that if you ever have need of one
  936.           of those old addresses or contacts, you can just load oldset and
  937.           undelete what you need. 
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.           List-It!                     -34-                                       REORDER
  946.  
  947.                This option allows you to reorder or change the order that
  948.           the records in your database take. This option also affords you
  949.           another view of the records in your database, besides the one 
  950.           given to you in the Browse module. In Browse you are shown one 
  951.           record at a time. In this module, you are shown 19 records at a
  952.           time, which some might find to be a more convenient way to view
  953.           your records. 
  954.  
  955.                For instance, suppose you are maintaining a certain order
  956.           in your database, so that you can take advantage of special Postal
  957.           Rates. Or maybe you are keeping your database in a certain order
  958.           for when you print out your records. But you notice that there are
  959.           a few records that need to be relocated. You would then need to
  960.           choose ReOrder from the Utility sub-menu.
  961.  
  962.                Upon entering this module, you will be shown the first 19
  963.           records in your database, one per line. A pointer arrow will also
  964.           be displayed at the first record position. The command area at the
  965.           bottom of the screen shows the active keys here. 
  966.  
  967.                You use the up and down cursor keys to move the pointer arrow
  968.           to the record that needs to be moved. You can also use the Page Up
  969.           and Page Down keys or the End key to move the arrow. Once the arrow
  970.           is pointing at the desired record, you hit the Enter key. This
  971.           record will then be highlighted. 
  972.  
  973.                Now you must move the pointer arrow to the location in the
  974.           database you wish to move the record to. Let's say you wish to 
  975.           move the selected record to the 33rd position in your database.
  976.           You must move the pointer arrow until it is at the 33rd record
  977.           position. Then hit the Enter key to select this position. A window
  978.           will pop up, asking if you wish to move the record. The top line 
  979.           will display the actual record numbers. For instance, it might
  980.           read;                Move record 67  to  33
  981.  
  982.                When you hit the <y> key the record will be moved. You can
  983.           move as many records as you wish, there is no limit. Once you move
  984.           a record you will see on the bottom of the screen the words,
  985.           Undo Swap, next to the F8 key. If you were to press this key, then
  986.           the last move that was made would be undone. In other words, the
  987.           record that used to occupy the 67th position and was moved to the
  988.           33rd position, will then be moved back to the 67th position.
  989.  
  990.                When you exit this module and you have moved at least one
  991.           record, then the entire database, in its current order, will be
  992.           written to disk. This just means that when you use the ReOrder
  993.           module to change the position of one or more records in your
  994.           database, then the entire database, will be written back to disk;
  995.           thereby saving the changes you have made. This is done
  996.           automatically. 
  997.  
  998.                As always, help is available when you press the F1
  999.           key.
  1000.  
  1001.                
  1002.  
  1003.   
  1004.           List-It!                     -35-                                      AFTERWORD
  1005.  
  1006.  
  1007.                I believe that this manual covers all the functions the
  1008.           program has at this date, (1/27/92). Future versions will of
  1009.           course, include more functions and refinements, and the inevitable
  1010.           minor bug fixes. If you can think of some refinements or 
  1011.           improvements, please feel free to contact me. Then, if I agree
  1012.           about the usefulness of the suggestion, I'll make the addition, 
  1013.           and submit the new version to the author of the suggestion.
  1014.  
  1015.                So please, if you find the program to be of use, do the right
  1016.           thing and register. Because then you will give me the incentive to
  1017.           keep the program growing in abilities and functions. 
  1018.  
  1019.                Please send any comments, questions or suggestions, to me at
  1020.           the following address:
  1021.  
  1022.           Luis Sanchez
  1023.           2625 SE 2nd Court
  1024.           Pompano Beach, FL 33062
  1025.  
  1026.           Or you can send E-Mail to me through Compuserve. My address there
  1027.           is:  # 71237, 2721.
  1028.  
  1029.           Compuserve is probably the best way to get a hold of me. Just allow
  1030.           a few days for a reply.
  1031.  
  1032.           For the encouragement, I thank you.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.           List-It!                     -36-                                      LICENSE
  1064.  
  1065.  
  1066.               List-It! version 1.0, and all future versions to come, are
  1067.           the copyrighted property of Luis Sanchez. They are not public
  1068.           domain software, nor are they free software. They are placed in
  1069.           the public domain under the user supported shareware concept. 
  1070.  
  1071.               This program may not be used in any commercial venture, nor
  1072.           as a sales aid of any kind, without registering it with the
  1073.           author. 
  1074.   
  1075.               Corporate and government users are required to register
  1076.           their copies.
  1077.  
  1078.  
  1079.                             THIS IS NOT A FREE PROGRAM
  1080.  
  1081.                Under the shareware concept, you are allowed and in fact
  1082.           encouraged, to freely copy and distribute this program to others
  1083.           as long as it is not modified in any way (including, but not
  1084.           limited to decompiling, disassembling or otherwise reverse
  1085.           engineering the program,) and as long as all documentation files
  1086.           accompany it. 
  1087.  
  1088.  
  1089.                                  REGISTRATION
  1090.  
  1091.                If you find yourself using List-It! after a few weeks, you
  1092.           obviously consider List-It! to be of some value. Please do the
  1093.           right thing and register your copy. You've had the opportunity to
  1094.           freely test-drive the program, to see if it proved useful to you.
  1095.           So, in all fairness, you should respond in kind and send in your
  1096.           registration fee. 
  1097.  
  1098.                This would allow for continued support and maintenance of
  1099.           the program and will ensure that future programs will be issued
  1100.           through this channel.
  1101.  
  1102.                Registering your copy entitles you to notifications of
  1103.           future upgrades and/or bug fixes. Another reason to register is
  1104.           that I will send you a copy of the program without the shareware
  1105.           messages. 
  1106.  
  1107.           Distributors of public domain software or user supported
  1108.           software may only distribute List-It! after first obtaining
  1109.           written permission. Please write for details. 
  1110.      
  1111.           When registering your program, please use the form outlined
  1112.           in the file LST-REGI.DOC.
  1113.      
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.           List-It!                     -37-     
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.                               DISCLAIMER OF WARRANTY
  1131.  
  1132.                THIS SOFTWARE AND MANUAL ARE SOLD "AS IS" AND WITHOUT
  1133.           WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER
  1134.           WARRANTIES WHETHER EXPRESSED OR IMPLIED.  BECAUSE OF THE VARIOUS
  1135.           HARDWARE AND SOFTWARE ENVIRONMENTS INTO WHICH THIS PROGRAM MAY BE
  1136.           PUT, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED.
  1137.  
  1138.                GOOD DATA PROCESSING PROCEDURE DICTATES THAT ANY PROGRAM BE
  1139.           THOROUGHLY TESTED WITH NON-CRITICAL DATA BEFORE RELYING ON IT. 
  1140.           THE USER MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM.  ANY
  1141.           LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO PRODUCT
  1142.           REPLACEMENT OR REFUND OF PURCHASE PRICE.
  1143.  
  1144.  
  1145.                IN NO EVENT WILL LUIS SANCHEZ BE LIABLE TO YOU FOR ANY
  1146.           DAMAGES, INCLUDING ANY LOST PROFITS, SAVINGS OR OTHER INCIDENTAL
  1147.           OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO
  1148.           USE THIS PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.           List-It!                     -38-  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.                                ORDERING INFORMATION
  1189.  
  1190.  
  1191.  
  1192.                A List-It! registration grants you the right to use the
  1193.           program on a regular basis. Registration includes mailed
  1194.           notification of updates and priority support through the mail. 
  1195.  
  1196.                You can purchase an individual registration for $19.95. This
  1197.           fee covers registration of the program, plus the costs of mailing
  1198.           a copy of the latest version out to the user. Of course, I can not
  1199.           guarantee that when you send me the registration fee, the version
  1200.           that I mail to you is different from the version you already have.
  1201.           
  1202.  
  1203.  
  1204.                  THE REGISTERED COPY WILL NOT INCLUDE ANY SHAREWARE
  1205.           COMMERCIALS. 
  1206.  
  1207.  
  1208.  
  1209.                These prices shall be good through the end of December 1992,  
  1210.           after which, prices, conditions and/or terms will be subject to
  1211.           change. 
  1212.  
  1213.                When registering your program, please use the form outlined
  1214.           in the file LST-REGI.DOC.
  1215.      
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.           List-It!                     -39-